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(54) System and method for propagating revisions through a communications network 



(57) A system, and method of operation, for propo- 
gating revisions through a communications network. 
The system includes: (1) status reporting circuitry, asso- 
ciated with a second node of the communications net- 
work, for collecting and transmitting a current status of 
second node information stored in a memory of the sec- 
ond node, (2) first information revising circuitry, associ- 
ated with a first node of the communications network, 
for receiving the current status from the second node, 
determining as a function of the current status whether 
a revision of the second node information is required 
and, if the revision is required, transmitting the revision 
to the second node to revise the second node informa- 
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tion and (3) second information revising circuitry, asso- 
ciated with the second node of the communications 
network, for receiving a current status from a third node 
of the communications network, determining as a func- 
tion of the current status from the third node whether a 
revision of third node information stored in a memory of 
the third node is required and, if the revision is required, 
transmitting the revision received from the first node to 
the third node to revise the third node information, the 
revision thereby propagating through the communica- 
tions network via the first, second and third nodes 
thereof. 




BEST AVAILABLE COPY 



Primed by Rank Xerox (UK) Business Services 
2.14.8/3.4 



_0782080A1J_: 



EP 0 782 080 A1 



Description 



COPYRIGHT NOTICE 

a nnrtinn of the disclosure of this patent document contains material which is subject to copyright protection. The 
whatsoever. 

TECHNICAL FIELD OF THE INVENTION 

Tho nroC pnt invention is directed in general, to communications networks and. more specifically, to a system and 
me tX^^ a hierarchical communications network that cascade the updates through 

the network as a function of its hierarchy. 

BACKGROUND OF THE INVENTION 

lmmeasurab.e gains in technology offered in personal computers ("PCs'} have aW PCs <™££££ Z, 
formed only by mainframe or minicomputers in the past. Many compan.es and. for that mattery ridiv.du al wnnv 
ZaS oTcomm?cially-available PCs to meet their information processing needs. Thus, it is vrtal that the* PCs perform 
Sr^L«8 of a given computer system is a sensflve issue with companies and ,nd,v,dua. users g.ven 
the level of reliance they place on their computing systems. . lQr . 

MM* PCs were stend-alone devices, each containing separate hardware. ^^^^'^^^ 
and user data As use of PCs spread within business organizations, however, the need for shared date and hardware 
^ucWo^^ocal area network ("LANs") came into being. A LAN (or its more-geographical ly-dispersed coun- 
^mmSZZl ("WAN")) includes a number of PCs ("clients") linked to one another (typ.ca.ly by a h.gh 

delivers programs and data to the clients and manages system-wide resources, such as secondary storage unrts and 

Pfin The networking concept has proven very useful, but suffers from a couple of disadvantages. First since manage- 
ment of the netorkte focussed in the server, the overall performance of the network is co.nprc-m.sed whenever the 
s?rve ^blcom^a pricing bottleneck. Second, since programs and data are delivered by the server to ,te vanous 
SentsSSrtion problem'occurs whenever a software provider or vendor modifies one of rts P^amsor date .The 
modrfied program or date must typically be distributed from the server to the client computers .n a timely manner, often 
Sn a T day. InTprior art solution, the server, or a "host" computer identified by the server, .s respon- 
se for sSuenSally traversing each of the client computers supporting an W version of the modrf.ed program or 
date aSn updating those client computers as necessary to implement the "new" version. In an alternate pnoart 
so^on the server, or?he host computer, traverses each client computer, updating each to include certa.n ones of the 

SerV A r problem inherent to the prior art solutions is that substantial server, or host. V*^^^^ J*^"! 
establishing a communication link with many, if not all. of the client computers, and then updatmg the same. Furtt^ , 
the server is responsible for performing the updates and the number of client computers be.ng sensed by the server 
increases the overall performance of the network may significantly be compromised as the server becomes a process- 
ing bottleneck. A system and method are needed for propagating revisions to programs or data through a communica- 
tions network wherein the communications network, and in particular the server's resources, are nerther compromised 
nor wasted The inability of conventional solutions to accomplish the foregoing remajns a dom.nant obstacle to updatmg 
software products distributed among various ones of the client computers of a communications network. 

SUMMARY OF THE INVENTION 

To address the above-discussed deficiencies of the prior art. the present invention provides a system, and method 
of operation, for propagating revisions through a communications network, wherein the commun.cat.ons network 
includes a plurality of associated nodes. . . 

The system includes: (1) status reporting circuitry, associated with a second node of the commun.cat.ons ne^ork 
for collecting and transmitting a current status of second node information stored in a memory of the second node (2 
first information revising circuitry, associated with a first node of the communications network, for receivmg ttie i cuoent 
status from the second node, determining as a function of the current status whether a rev.s.on of the second node 
information is required and. if the revision is required, transmitting the revision to the second node to rev.se the second 
node information and (3) second information revising circuitry, associated with the second node of the commun,cat.ons 
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network, for receiving a current status from a third node of the communications network, determining as a function of 
he current status from the third node whether a revision of third node information stored in a memory^ ^ theSd node 
SSESSf - ' 7*2 iS reqU,red> transmittin 9 th * ^-on received from the first node to the Srd nooV r^t 
5 I ZZ jstveT ' reV ' S,0n th6reby Pr ° Pa9atin9 thr ° U9h commun ^ions network via theTS s3 

NnH« ?n P «Ll Sen l in T ti0n there< ° re a " 0WS revisions to P r °P a 9ate automatically through a communications network 
and la" 21 r responsib,e for botn de ^ n 9 when a revision to information in another node fe niessTy 
and transm,tt,ng the rev, S1 on to the other node. ••Information." as used the term is used herein is defin* S 
encompass both .nstructions (e.g. , programs, functions, tasks, subroutines, procedures and the lite and data THp 

S™=?== ~ r==Esa=s=s 

update serv.ce, where.n subscriber pay for revisions. The amount of information revised and the frSuencv of it ~vf 

E^ET 6 Se 'f f 61 allOWin9 3 ran9e ° f fee " based services to be offe ^- * reSed^St S sSer 
STSriTT ^ SUitabl/ Pr ° CeSSed t0 Wenti,y a Subset * the information of the subVaTber ^liS th«l ava.1 

In one embodiment of the present invention, the second information revising circuitry is embodied in a -„p„™ n , 

thermore not .imitate c^^EST^ «7llS ^v&^EflT^ The J res *<" inventi °" « ^ 
n^^ 

storage medium. The instr^ a surtab, <* conventional memory or other equivalent 

cuitry. The instructions. upon^tZ IteSF^S^&Z Z ™ "T 0 *." 0 ** ha ™9 Pressing cir- 
tions network wherein ^communic^^^ comm-io* 

trr=^^ 
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BRIEF DESCRIPTION OF THE DRAWINGS 

For a more complete understanding of the present invention, reference is now made to the following descriptions 
taken in ^SSSS the accompanying drawings, in which .ike numbers designate like parts, and ,n wh,ch. 

FIGURE 1 illustrates a block diagram of a conventional hierarchical communications network in which the principles 

SguT^ ^ — « provdes a sui,aue env r 

SrrS— tion may be implemented and operated in accordance wKh the communions 

fSrE 3 iHutiTtes a high-level blockdiagram of an exemplary microprocessing circuit that may suitably be asso- 
Tte system of FIGURE 1 and that provides a suitable environment within wh,ch the present 

SrE ^^X^^ of a single exempiary branch of the communications network of 

FIGUrI Simulates a flow diagram of an exemplary method of operation for P«£*^*" * reu * •» 
communications network of FIGURE 1 in accordance with the pnncples of the present invention. 

DETAILED DESCRIPTION 

Referrinq initially to FIGURE 1, illustrated is a block diagram of a conventional hierarchical communications ; net- 
work TcoZm network (genera y designated 100). in which the principles of the present mvention may advanta- 

network 100 includes a server node 110 and a plurality of cor^ona. dient 
^ e i«f« iSr Aoaisof and 140a-140h "Include." as the term is used herein, is defined as inclusion without hm- 
itatn fiSFm * * Xm ^^X defied as any junction, end or connection point, station, terminal a »e 
IKh^ that is capable of communicating signaJs, or information, within communions network 

100 Server node 110 may suitably and conventionally be sharable by client nodes 120a-120c ^O 3 - 13 ^.^ 3 ; 
140 f Server 1lZd client nodes 120a-120c. 130a-130f and 140a-140h may suitaHy be assorted I with one 
l^er e*er drecDy or indirectly, by any conventional means, including communicate hnks. portal devices ,{e.g 
rorftrs SSL Se^ys switches, etc.) or the like. "Associated with." as the term is used herein, means to .nclude 

prate with interleave or the like. "Or," as the term is used herein, is inclusive, meaning and/or. 

^ I20a-120c. 130a-130f and i^a-l^hsuitablyfacilitates resource sharing 

as wrSSj^e requests among ones of the nodes, techniques that are known in the art Co mmu- 
nfcTtbn amonrvarious ones of the nodes may suitably include the transmission and reception of signals. Each com- 
mSSion Sal may suitably be divided into packets, frames, messages, sequences of data or any other va .at onof 
oonvey'ng information. A typical signal may suitably include a collection of related data items. 
iS^iSSSXZ. address or instruction objects that may be used to communicate information between venous 
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h an advantageous embodiment, as will be discussed in greater detail with reference to FIGURES 4 and 5. rev. 
sions to attest a portion of the information stored on server 1 10 may surtably be propagated on a ^y^l bas« 
Sough Communications network 100 in accordance with the principles of the present .nventon. 
to m l used herein means changes, modifications, additions, deletions, adjustments, alterations, variations custom,- 
zattons and the S. More particularly, at least one of the second level nodes 120a-120c coHects and transmits a seo- 
onS .Ze^rrent status of ilrmation stored in the one or more second .eve. node. The s«x,nd * 
information may suitably be for the entire level or for individual ones of second level nodes / 2 ° a - 1 ^^.?^ r ri y | °- e a . 
S level node receives the second level current status of information and determines, as a function of the second level 
cSS statos of formation, whether a revision of one or more of the second level nodes" information .s required. If the 
riSont requir^ 110 transmrts the region of the second level node information to the one or more second 

'^AntrThe reSon° C the one or more second level nodes 120a-120c may suitably receive a third level current status 
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of information from at least one third level node 130a-130f, and determine, as a function of the third level current statue 
information, whether a revision of the one or more third level nodes' information is requ i T^d^cunent 
status of rnformation may s.milarly be for the entire level or for individual ones of third level nodes 130^1 30f K he h!i 

rcm serlTt nTT* *" ° r r ^ SeC ° nd l6Ve ' n0d6S 120a - 12 ° C franSmit at ,east 2 J£ S 

from server 1 10 to the one or more tad level nodes 130a-130f to thereby revise the third level node information 

nnJT ^ portan, , as ,P e , ct of tne above-identified and -described enfcodiment is the breadth-first-type or "fan-out - 

S2J^3 T*!* V*"" to the ,irSt level node i^tion are suitably propagated through ones of X sec' 

.T " T' n0deS> and 80 ° a SUCh the rwisions to tneSst level noZStion^e 
propagated through communications network 100 in an exponential manner 'nwrmanon may be 

Turning to FIGURE 2. illustrated is an isometric view of an exemplary Drocessina svstem a Pr ( nanar *u w • 
nated 200). Processing system 200 is capable of functioning as any node fS^iST^wtS^S 
withm exemplary communications network 100. Processing system 200 suitably included I . C ha2c^ ! ? 
device 210 and a keyboard 215. Chassis 205 includes a hard T^^^^^^T^ k^S, 
dr.ve 225 may suitably be replaced by or combined with other conventional strurtures 

£L!?££ ? pe ^ d . compact disc drives> te,ephony systems and devices ^^S^^^TZ 

simile or the like), network communication ports and the like P 

operative to execute selected ones of the instructions stored therein to propagate revisions to the ctoroH 

T-LT* COmmu S tions netw °* in accordance with the princtple^ ** ^ 

terns. M dsvfces and ZSSSS^"'"' ** "* — • «"*■ s *- 

telly discussed In Date Helwnrl. |W, „ bv Darran l SnSn S),s,em nelw °* is TO™ 

Plenum Press (1992) and in The Irwin Hanrihnnk nf ToiJ* ^T* V ' ayes and S * R Weinstem, 

suitably be a serial or a parallel port lus^ZltoS^Tn?" "f^ S6t * Peripheral P 0 * 5 315 «™V 

I/O bus 325 may be assoSS l£! ^JSSS^TbSSS * SU " ab,e mSanS by WhiCh h0St bus 320 and 
ancewith the illustrated er^'imem noi^ 320 KS^JT^ ^2™°*™ th ^tween. In accord- 
ing circuitry 245 and detached local memo^lio ^ w ^ a, ^ e «^ «>"»nunication between process- 
maximize rii speed. ^S^TJSSZ^S^iy^ ^u 6 ^ with as ,ew «Wnents as possible to 
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in alternate preferred embodiments, microprocessing circuit 300. in whole or in part, may be replaced by or com- 
binei wTan ^suitable processing drcurtry. including programmable 

logic ("PALs") and programmable logic arrays ("PLAs"). d.g.tal signal processors ( DS Ps ") J^.eld P ogram m^e g^ 
arrays ("FPGAs"). appLtion specrfic integrated circuits ("ASICs"), very large scale .ntegrated circuits ( VLSIs^ or the 
like to form the various types of circuitry described and claimed herein. 

The pSsenUnJention provides a means by which revisions to information associated with one or more f .rst l«£nod» 
n^y?u1iTbTcoL!.nicated to one or more second level nodes, from at least one of the one or more second level 
ncTs totne or more third nodes, from at least one of the one or more third level nodes to one ~ ™ 
eto The present invention therefore facilitates the propagation of revisions through a commumcations network at an 

^urntna to FIGURE 5 illustrated is a flow diagram of an exemplary method of operation of communications network 
100 lo 7£££^L~ through branch 400 of FIGURE 4. and more particularly, server 110 and dient nod J 
20a and Zol in accordance with the present invention. The present discussion is undertaken wrth reference to FIG- 
URE Hri it is assumed that each of exemplary nodes 110. 120a and 130a includes a - rtaWe s .P rocess ^^ 
such as microprocessing circuit 300 of FIGURE 3 or other suitable implementation capable of proving equivalent fane- 
exemplary Lrce code embodiment is attached hereto as APPENDIX A and * "corpora t«T herein^ by rrf- 
erence for all purposes. The exemplary embodiment is written in conventual Korn Shell code for use wrth a UNIX 

memory associated therewith. The revisions may suitably be received from any of a number of sources, mclud.ng soft- 

thereon (e g files database, data configurations, programs, routines, subroutines, functions teste and the like) and 
genTaU a 'statos report (process step ioO). The status report represents the current status of client node 120a infor- 
nSSTr^ may suitably Include an identifier to identify various client node information, a version .number associated 
S various client node information, a revision date associated with various client "ode^ tnt "™*™- Z^iZJS 
scanning process may suitably be initiated externally by server node 1 1 0 or internally by client node 1 20a. In either sit- 
uation, the initiation may suitably be performed periodically or apenodically. 

Client node 120a. possibly using one of peripheral ports 315. transmrts the status report to server node^ 0 
(input/output step 505). Server node 110. possibly using one of its peripheral ports 315 receives the Uansmrtted^ 
report and suitably verifies the accuracy of the transmission (process step 510). Techniques for venfymg the transm.s- 

^^nanad^ntegTous embodiment, server node 110 is further operative to authenticate the current status of client 
node 120a by logging onto client node 120a. and confirming the information within the received status report. Authen- 
ticate" as the term is used herein, means to establish the authenticity of. prove genuine or the like, including confirm, 
corroborate, prove, substantiate, validate, verify, or the like. For example, if the received status report irdicates that ch- 
ent node 120a includes version 1 .0 of software package XYZ. server 1 10 may suitably log onto client node 120a to con- 
firm that client node 120a in fact includes version 1 .0 of software package XYZ. Often times, stored 'rrtormaton such 
as software package XYZ. includes a plurality of files. In a related embodiment therefore, server 1 10 authenticates the 
status report on a file-by-file basis. . . . , , 

Server node 1 10 if the status report was correctly received, determines as a function of the received status report 
whether a revision of client node 120a stored information is required (decisional step 515). In another advantageous 
embodiment, a suitable inventory is maintained, either directly or indirectly, by server node 1 10. The inventory includes 
a list of the information maintained, used, provided, or the like by server node 1 10. and possibly client node 120a. The 
determination of whether client node 120a stored information requires revision is suitably performed by comparing toe 
status report with the inventory thereby identifying information that (1 ) is missing from client node 1 20a. (2) may suitably 
be removed from client node 1 20a. (3) is not a recent version. (4) is expired, such as under the terms of a license agree- 
ment or the like. Conventional techniques for performing comparisons are known. 

In connection with licensing arrangements, the above-referenced identification process may surtably be used to 
identify valid, invalid, out-of-date or the like subscriber information maintained by client node 120a. an aspect of the 
present invention that is discussed in greater detail hereinbelow. 

If client node 120a stored information requires revision (YES branch of decisional block 515). server node 110 suit- 
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ably creates an information revision file for transmission to client node 120a (process step 520) An exemolarv inform* 
tion region Me may suitably include programs, functions, tasks, subroutines procedures ^miTSSiSlS" 
databases data files, data configurations, or the like. The revision file may ££Z£ mST^KSSSS; 

£ ! node 1 20a, ? e executed set of instrucfons TOy sui,aWy dire * 

der of the information revision file, perform transmission verifications, security or the like 

rinJ^T ?°? 6 1 Jo« P ^ SiWy U$ing 0ne of P en 'P heral ^ts 315. suitably transmits the revision file to client node 120* 
(input/output step 525). Client node 120a. again possibly using one of its peripheral ports 315 deceives Z tr^m 25 
rev,s,ons Me and verifies the accuracy of the transmission (process step 530) * f *e . tw£££ 
receded, the stored information on client node 120a is updated using the Z * 

m«?I H^ 9 t UP ? ate may 06 Perf ° rmed in ^ one <* a num ^ o» ways, for •JS3TSr!?S'llO 

may suitably update Cent node 120a stored information by logging onto client node 120a anTone of 

(a) perform the update in a conventional "master-slave"-type environment (i.e.. communications session in whirh 

Sf^s^sr* ,2oa •* -"*" * aiM ■~ ,e ^ — — 

performed on a file-by-file basis Wt P ° f " h,ch "** aga,n inc,ude a P lurali *y ° f «'<*. is 

server node 110. The deterrTafon of ^^^^a^^'lS^^ ^ 1303 " 
formed by comparing the status report with the invenl^^ * ^ 

node 1 30a. (2) may suitably be removed from client nori/i^nl . 9 intormat,on that < 1 ) 'S ™ssmg from client 

the terms of a license agreement, or ^e Z ' ™ " ' (4) fe such as «*r 

id J^^roui^aS srsisr rsrr process may —» * — * 

present inventJon that is discuS ed* I^JaTer de^h^Z """"" * ^ n °* 180 "' 3 " aSpe « °< ^ 
sion file may suitably include at lea^t in nart th* n • ™* iprocess step 560). The information rev - 

r «. to ,„ SB „ „. _ „ me ^r^nrr^s^j*^ 1 ;: 
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(^IransmrtasequencTol commands . oKen, no* ,30a M. upon axao*>n by oten, noda 130a. aoabU, dW 
node 130a to perform the update. 

L rtS by I r^vi region file, and then surtably executed, thereby allying one or more operator* of one of 

130 2S iTmation may suitably be revised, at least in part, by the revision file receded by cl.ent node 12te from 
se° er n^ot 110 The revision thereby propagates through the communications network v,a the f.rst. second and th,rd 

"^n aTelSd embodiment, the status report generated by client node 1 20a may be transmitted from client _no* M20a 
to serve nodtmaY aSS time, whereasthe status report generated by client node 130a may the, be 
L^uLS^Zil laoa to client node 120a at a second time. The second time may advantageously be subsequent to 
he" SSX . 52 X£££5 to a..ow client node 120a information to be fully ™sed before £rt i node 
tne Tirsi urne uy «* h» ^ further aspect of the present invention therefore is allowance of 

J^f^ ft network 100. In aitemate enfoodlmen* . reruns 

may suiSy be «L in a more random fashion, as one node determines that ^^^ZIZ ^ 
^ a^anSgeous application of the present invention is to subscriber-based software distnbuton systems. Sub- 
scrib^-basS systems " as the phrase is used herein, means electronic communications systems wherein a party. tt» 
"suSr^conJacIwSn ^vendor, distributor, licensor or the like to receive and pay for a certa,n number of .ssuej 
verier tnl Hke of a particular software package, group of software packages.; *lectr 

Particularly at least one of server node 1 10 or client node 120a includes memory for storing a subscnbe Wawwt 
fnTs^bscribSs wrth their subscribed to services. Server node 1 10 and client node 120a transmri revision f .les. at leas 
^pSf!TSli^arira«« of the subscriber list. The present invention therefore may surtably form the core of 
a feezed update service, wherein subscribers pay for regions. The amount of informatjon rev,sed and th 
lencv oi televisions may be selectable, allowing a range of fee-based services to be offered. In a related embod.- 
s !^be?fetTassodated with a restricted list. The restricted list, when suitably processed ,n assoc.at.on 

pTticuL user or group of users, such as a group of users associated by geograph,cal locat.on. for example. The 
rp<rfrieted list mav therefore functions as a filter for the subscriber list. 

Se^oSon of updates through a subscriber-based systems may be particularly advantageous, nrt only ever 
WANs suclTas the Irternet. but also through cable television systems, such as those proving pay-per-vew and 
demand-television. including emerging services for receiving vkieo games and othe. 

From the above, it is apparent that the present invention provides a system, and method erf I operatwn for propaga 
ino reSons through a communications network, wherein the communications network .ndudes a plurahty of assoa- 
L^TcSS The system includes: (1) status reporting circuitry, associated with a second node of the commun.cat.ons 
neto* to and transmitting a current status of second node information stored in a memory of me se^nd 

. node (2) ft st information revising circuitry, associated with a first node of the commun.cat.ons network. ^ rece-vrngthe 
cu7re* statos from the second node, determining as a function of the current status whether a rev.s.on of the second 
ZSSnUl and. if the revision is required, transmitting the revision to the second node to rev.se the 
SSIIiSn and (3) second information revising circuitry, associated wrththe second "ode of the commu- 
receiving a current status from a third node of the communications network. determ.n.ng as a 
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a l U l U u m the lhW n0de Whether 3 revision of thM information stored in a memory of the 
thwj I node B required and. rf the revision is required, transmitting the revision received from the first nodeTthe th'd 

22 ££T hIk ? T in u ,0rmation ' the revision *°«*>y Propagating through the communicator neJJor^e 

catnfn^ T n0deS ther60f - ReViSi ° nS are ther6f0re a,lowed 10 P^' 6 automatically through7clmuni 
cations network, wherem vanous nodes within the communications network are responsible for both detecting Xn 1 
re^on to information in another node is necessary and transmitting the revision She omer ncSe 9 

FIGlTr^T? 27? ? ?! Pr6S f l invention is not limited to tree-based hierarchical networks of the type set forth in 

FIGURES 1 4 and 5. but also .ncludes other conventional networks configurations such as Deer-to-oeer 

t.ons networks. The propagation of revisions is also not limited to a first node to a I^iS^.^KSJSSS" 

•on. but rather includes revision of a first node propagated to one or more second woTX, a 

ormore second nodes to one or more third nodes, from at ««»o»f»or»«mo^^i^rn2S^ 

o^u^^^ 

wa iThT 6Sent r ention J s also not limited to P«re "computer-based" communications networks such as LANs or 
WANs, but may also surtably be implemented in telecommunication systems to update systeTsof^aTe or da£ or in 

n^ enV l 0nmentS ' SUCh 35 Ce " U,ar te ' eph0n * or messa 9 e P^9 networks To Z Z ZZllZ oiTe 

hri?^ !T ma> : !. Uitab,y b6 aSS ° dated With any network e,eme * Zoning as ^ode TESTES 

bndges. gateways, switches, or other conventional portal devices satellites relav station* „ thTiL 2. 

Pies of the present invention have been described'* detai,. t^m^^J^X^Z 

i:tb3e s sttr es,s ^^ 
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ft PPRNDTX A 

USEMQI JSI ll SOURCE c.ODE 



CMD=~basename $0' 

USAGE-'Usagc: SCMD ( -d ) I -s servcriD I 

KSHOK»no 

echo yes | read KSHOK 

ifiesfSKSHOK' - -no"; then 

if test ^{RETRYING JCSH:-no}" - y« * * cn oo . 

echo -$CMD: ERROR: not running with ksh88 - aborting! ^ 

echo -$CMD: ERROR: not running with Ksh83 - aborting! I 

/bin/mail exptools 

RC»2 
clif test S*-gt0; then 

RETRYING,KSH--yes- SSHELL $0 

RC-S? 

else 

RETRYING KSH- "yes- SSHELL $0 
RC-S? 

n 

exit SRC 



# < emsg 

* This routine prints out error messages and mails them to exptools 
emsz() { 

typeset MSG~*SCMD: ERROR: $1 - aborting!' 

typeset LOG-$ADMRUG/SSERVERlD/locai/scndpiist.out 

typeset ECODE ECMD 

if test -n *S2"; then 

echo S2 | read ECMD ECODE . Mm .* 
MSG * * $MSG\nError SECODE' reported by SECMD 

n 

echo-SMSG" >&2 

' echo 'Subject: sendpiist error!" 
echo 

echo "SMSG" 

if test -s SLOG; then 

echo "\nHcrc is the complete sendpiist log file:' 
echo ' ~ 



pr -o4 -t SLOG 
echo " 

fi 



} | /bin/mail exptools 

} 

^ < extractscction 

0 This routine extracts given sections of input files that arc terminated by 
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* the EOF line. 

extractsection() { 
integer scction«$l 
cypeset inputfilc-$2 
integer i= l 

typeset LINE done- faise 

while not Sdone && read LINE; do 
if ((i > section)); then 

done » true 
ciif test "SUNE" - "SEOF'; then 

(0 += l» 
clif ((i «» section)); then 
echo "SLINE* 

fi 

done < Sinpurfile 

} 



ff < main 



GETOPT»$(getoptds: *$@") 
if (($? !=())); then 

echo *$USAGE - 

exit 2 

fi 

set - SGETOPT 

ffscl •< ft Exit on any error 

debug*" - 
SERVERID = - 
for arg in "S®*; do 

case "Sarg" in 

-s) 

SERVERID* 52 
shift 2 

<) 

debug"-: 

shift 

") 

shift 
break 

esac 
done 

if test ! -f SADMRUG/global/config; then 
emsg -Can t find RUG global config file" 
exit 2 

fi 

. SADMRUG/global/config 



if icst -n "SSERVERJD"; then 
FOUND = false 
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for ID in SSERVERIDLIST; do 

ifiest'SlD" - "SSERVERID"; then 
FOUND* true 

ft 

done 

if not SFOUND; then 

cmsg "Unknown serverid SSERVERID* given" 
exit 2 

rt 
else 

if test -z "S DEFAULTS ERVERID": then 
emsg "Default server id missing" 
exit 2 

ft 

SERVERID = SDEFAULTSERVERID 

fi 

exec > SADMRUG/$SERVERlD/local/sendpiist.out2>&l 
echo 'Start *datc*\n" 

C ASC ADEFILE = $ ADMRUG/SSER VERID/ global/ cascade 
if test -f SCASCADEFILE: then 

cp SCASCADEFILE SADMRUG/local/cascadefile 

chmod 664 SADMRUG/local/cascadefile 

fi 

. SADMRUG/global/linkconftg SSERVERID 

NETINFO«S(echo SSERVERID STYPE | SNETCMD) 
if tesi -z "SNETINFO"; then 

emsg "Unable to acquire network information" 

exit 2 

n 

echo "Networking information: SNETINFO" 

tmppkglist=/usr/tmp/$Spkglist 
tmpplist=/usr/tmp/$$plist 
tmpexciude=/usr/tmp/$$exclude 
tmp ignore =» /usr/tmp/$$ignorc 
mkperrs = /usr/tmp/SSmkperrs 
errfile » /usr/tmp/SSerrfile 
tmpsubfile =» /usr/ tmp/SSsubfile 

tmpflist="Stmppkglist Stmpplist Stmpcxclude Stmpignore Smkperrs Seirfile StmpsubfUe" 

rcrval«0 
trap ' 

rerval= l 

exit 
' 12 3 15 
trap * 

rm -f Stmpflist 

exit Srerval 
' EXIT 

cd 

rm -f adm/updl . 1/lib/cpio.new » Remove emergency update list 

echo "\nComputing the subscription list ..." 
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echo "The 5LOGNAME usend uses the alias ' S LOC AJLC LIENTID ' to subscribe to the 
following 5 TYPE tools from 'SSERVERTD*:* 



cat SSUBSCRUST | 
CleanCooun | 
scd T'/d* | 
son -f > Strapsubftie 
if test -s Stmpsubfile; then 

pr -o4 -c -4 Stmpsubfile 

else 

echo "NONE!" 

fi 

catSSUBSCRUST | 

CteanComm | 

sed 'r[*\)fd\ $/**//' | 

son -f > Stmpsubfile 

if test -s Stmpsubfile; then 

echo " rejecting these tools:' 
pr -04 -c -4 Stmpsubfile 

fi 

} > SADMRUG/local/subscrlisr 
chmod 664 SADMRUG/locai/subscrlut 

echo "AnComputing checksums...' 



* Combine *all» subscr-list files 



# Combine •all* subscr-list files 



( 



* Combine •all* cxcludc-list files 



> Serrfile 

> Smkperrs 
{ 

cat SEXCLUDELIST 
gcnlinkdirs SSERVERID 
} | mkscd > > Stmptgnorc 

{ Hnd . ! -name V -print 1 1 echo Tind %V > Serrfile ;} | 

sed -e '$r\./!!' -f Stmpignore 1 1 echo "sed %V > Serrfile ;} 1 

{ STADMRUG/bin/mkplist -m2> Smkperrs 1 1 

, echo •mkpiist S?" > Serrfile ;} I 

V 50 " „ II echo "sort $?• > Serrfile ;} 

if test -s Serrfile; then 

if test -s Smkperrs; then 

^ cat Smkperrs > > SADMRUG/SSERVERID/local/sendplist.out 

emsg "Failure preparing client plist report" •$(< Serrfile)* 
exit 2 



else 
fi 



echo "SEOF" 



) > Stmpplist 
chmod 664 Sonpplist 

eval S{debug:+"cp Stmpplist SADNiRUG/SSERVEMD'} 

if «S(TZ=GMTdate +%H) < 2)); then » if before 2AM GMT 

integer W/UTTIME.RANt>OM% 1800 , set 1/2 hour random delay 

echo \nWaitmg SWAJTTIME seconds to prevent server overload- 
sleep SWAJTTIME 

fi 

echo "\nSending to SSERVERID* 
echo "SNETINFO* J 

Sdebug SSENDCMD -u SSERVERIDJ-OGNAME -f rjeySSERVERID/SLOCALCLIENTID.SYRDAY Stmpplist 
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> Serrfile 

cat SSUBSCRLIST | * Combine •all* subscr-list Hies 

CleanComm | 
5 sort-u 

echo "SEOF* 

{ cat SEXCLUDEUST * Combine •»»• exclude-list files 

genlinkdirs S5ERVER1D 

> ! 

1U CleanComm | 

sort -u 

echo -SEOF* 

if test -z -SDEFAULTLOCAUD"; then 

echo -0:SLCX:ALCLIENTlD:S(unamc -n) : SLOGN AME:$(uname -rvm) 

else 

75 typeset UNKDIR-$ADWRUG/$DEFAULTLOCALID 

typeset RJE-$HOME/rjc/SDEFAULTLOCALID 

echo "0:$LOCALCUENTID/$DEFAULTX.OCALID:$(uname -n):$LOGNAME.$(unamc -rvm) 
if test -f SUNKDIR/scrver/exptab; then 
sort SUNKDIR/seTver/exptab 

20 while IFS - : read CLIENT REST: do 

if test -f $RJE/$CUENT.plcg; then 
integer COUNT -0 

extractsection3 SRJE/SCLIENT.pkg | 
while IFS read COUNT CT ND UID OS: do 
((COUNT -h- D) 

25 echo -$COUNT:$CT:$ND:$UID:$OS- 

done 

n 

done 

fi 

30 echo "$EOF* 

) > Stmppkglist 
chmod 664 Stmppkglist 

eval S{debug: + *cp Stmppkgiist SADMRUG/SSERVERID*) 

5 Sdebug SSOTCMD «u SS ER VERID_LOGN AME -f rje/$SERVERlD/$LOCALCUENTID.pkg Stmppkglist 

if [ -s Smkperrs ]: then 

' echo "Subject: mkplist errors on $LOCALCLIENTU)\n* 
40 scd 's/"/$LOCALCUENTID:scndplisi:$TYPE:/" Smkperrs 

} I 

/bin/mail SSERVERMAUL 

» Log the error messages 
echo 'Errors:* 
45 cat Smkperrs 

fi 

rm -f /tmp/shSS.l 
echo *\nFimsh *date* 

50 
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"SENDIJPDT" SOf iwrp rp PF 



CMD = * base name $0 v 

USAGE= "Usage: $CMD ( -cdprR ] [ -J iocallD ] ( -t threshold ] client" 

KSHOK»no 

echo yes | read KSHOK 

if test "SKSHOK* » "no"; then 

if test "${R£TRYlNG JCSH:-no>- * "yes"; then 

echo "SCMD: ERROR: Not running with lcsh88 - aborting'" 
RC = 2 
eiif test $# -gt 0; then 

RETRYING KSH=*yes" SSHELL $0 "S@" 
RC-$? 

else 

RETRYING JCSH«"yes" SS HELL SO 
RC = $? 

fi 

exit SRC 

fi 

alias -x echo= "print -" 



ft < cmS g 

tt 

* This routine prints out error messages and mails them to exptools 
emsg{) { 

typeset MSG- "SCMD: ERROR: SI -aborting!" 
typeset LOG = Soutfile 
typeset ECODE ECMD 

if test-n "S2"; then 

echo S2 | read ECMD ECODE 

MSG~-SMSG\n£rror SECODE' reported by SECMD*" 



echo "SMSG" >&2 
{ 

echo "Subject: send updates error!" 
echo 

echo "SMSG" 

if test -s SLOG; then 

echo "\nHere is the end of the sendupdate log file " 

echo " 

tail SLOG | pr -o4 -t 

echo ■ 

fi 

} | /bin/mail exptoois 



# < findclicnt 

ft 



0 This routine returns a list of machines of the type defined by the first arg 
fmdcliemO { 
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machines type- -SI | sort 

J 

u ■ ■■ — < cleanupclient 

I This routine removes old rjc files for a designated client. 

clcanupcheiuO { 

typeset CUENTID-Sl today- $2 
typeset rmpatiern lodayfile 

yr» *date , + %y ,t 

T^ZT%^%CU^MW)^ SRJE/SCUENnD.diff 

rmpartern- "SRJE/SCUENTID ${yr}* # . 
today file - *SRiE/$CLIENTID. Stoday" 

for x in Srmpartern; do n^n 

.ftest'Sx' !- -Stodayfilc* -a Sx" !- Srmpanern . then 

${debug} rm Sx 

fi 

done 

> 

# „ < dcletefiles 

* 

U This command deletes files from a client 

%TScin»e .v -p SEXPPKCID -c -P SEXPPWD -M SSERVERMAIL "SO" name- -SCUENTID 
} 

# < deleted irs 

8 This command deletes directories from a client 

dCl £fnLdir -v -p SEXPPKCID -c -P SEXPPWD Saituid -M SSERVERMAIL W name- -SCLIENTID 

> 

g < scnddelfiles 

0 

» This routine sends the commands to delete files from a client 

senddelfilesQ { 

rvpeset CLIENT© -SI dtffile-S2 

typeset pattern- \( * ordinary (non^lir) file pattern 

if (( < 'Sp*«*™ # Sdiflile) > 0)); then 
echo *\tRcmovc files:* 
scd -n •slSpaoern! M«P* *4iffdc 

sed -n -s'Spatterntrm *\lMp" Sdiffile | 

{ 

n Do the standard setup 

echo HOME-expr 'SO' : •\(.»\)/adm/bin/-* ' 
echo '. SHOME/.cronprofile' 
# Now get the user commands 
cat 
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} > Stmpcmdfile 

rex *v -p SEXPPKGID -r priv -P SEXPPWD SaJtuid -M SSERVERMA1L -f Stmpcmdfile name- -SCLIENTID 



# < sendchmods 

ft This routine sends chmod commands co a client 

scndchmodsO { 

typeset CUENTID-Sl diffue-S2 

typeset pattern- * *\([0-9)*\) \(. *\)$' ft cbraods file pattern 

if (( $<grcp -c "Spancrn" Sdiffile) > 0)). then 
75 echo "\tChange files:* 

sed n *s!Spaaern! M \2!p" Sdiffile 

sed -n *s!$panern!chmod U '\2'«p' SdifTiIe | 

{ 

if Do the standard setup 

echo 'HOME-'expr *$0' . *\(.*\)/adm/bin/'* * 
20 echo SHOME/.cronprofile' 

if Now get the user commands 
cat 

} > Stmpcmdfile 

rex -cv -p SEXPPKGID -r pnv -P SEXPPWD Sal mid M SSERVERMAIL -f Stmpcmdfile name- -SCLIENTID 



fi 



* < sendrrmdirs 

» 

30 sendrrmdirs<) { 

typeset CLIENTID-S1 diffile-S2 

typeset pattern- A - \(.*\)/S' # directory pattern 

if (( S<grep -c 'SpaneriT Sdiffile) > 0», then 
echo "VtRemove directory:" 
35 sed -n "slSpattern! \l'p" Sdiffile 

sed -n "s!$pattern!-<ni'!p' SdifTiIe | 
sort -r | 

xargs -s350 echo dclctedirs | * echo the function we want 
cva! "S(cat)* # exec constructed function 



) 



tf < scndrepfiles 



sendrepfilesO { 

typeset CUENTID-S I difTile-S2 

integer oncmcg- 1046576 ft number of bytes in a one meg file 
integer bsize g number of bytes in a block on this machine 

integer limit » maximum size of cpio file in blocks 

so rypesct CPIOFLAGS # flags for cpio 



55 



: S(machtypc) 

in ibm) bsize -4096 tt ibm uses 4096-byte blocks 
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*) bsizc«5l2 # everyone else uses 512-byte blocks 



esac 

((limit - oncmeg / bsize)) # calculate the block size limit of Hies 
scd -n "s!+ \(.*p]\)/*\$r\r!p" Sdiffile > Stmpclist 
if I -s 'Stmpclist - ); then 

inicgcr sum«0 size 
echo 'UUpdate files:" 
scd '&r/ C Stmpclist 

> Stmpwlist 

xargs Is -sd < Stmpciisi | 
{ 

CPIOFLAGS = "-oc" 
iftest -STYP" « "mipMhen 
CP!O«expcpt0 

else 

CPlO*=cpio 
15 if SSVR4; then 

CPlOFLAGS«"-0 -Hodc* 

n 

fi 

while read -r size filename; do 
((sum « sum + size)) 
20 if [[ Ssum -gt Slimit && -s Stmpwlist ]); then 

SCPIO SCPIOFLAGS < Stmpwlist > Stmpcpio 

Sdcbug sendepio -v -p SEXPPKGID -c -P SEXPPWD Saltuid -M SSERVERMA1L -f Stmpcpio 

name"SCLlENTID 

((sum «■ size)) 
> Stmpwlisc 

fi 

echo "Sfilename" > > Stmpwlist 
done 

SCPIO SCPIOFLAGS < Stmpwlist > Stmpcpio 

Sdebug sendepio -v -p SEXPPKGID -c -P SEXPPWD Saltuid -M SSERVERMAIL -f Stmpcpio name= =SCL1ENTID 

> 

# < dirlog 

tt 

35 dirlogO { 

rypesetCLIENTlD = Sl diffile«$2 

sed-n-/\/S/s%\(.*\).%*date + %y%m%d' W %p" Sdiffile > > SLINKDIR/clicnt/SCLIENTID/dirlog 

} 



U < updlog 

n 

updlogO { 

cypeset CLIENTID«S1 diffile=$2 

sed-n -A/S/!s% A %^date + %y%ra%d* %p' Sdiffile > > SUNKDlR/clicnt/SCLlENTID/updlog 

} 

U < plistOK 

* 
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plistOK() { 

typeset plistfile- SI 
typeset RC 

if test! -f 'SpHstfile - ; then 
RC-i 

elif test "$(tail-l Splistfllc 2>/dev/null)- *SEOF" then 
RC»l 

else 

RC-0 

ft 

return SRC 



ff < pkgfUeOK 

pKgnieoKo { 

typeset pkgfile-S I 
typeset RC 

if test I -f -SpJcgflle"; then 
RC-I 

ehf test -$(tacJ -1 Spkgfile 2 > /dev/nuii) ■ "SHOP*- then 
else 

RC-0 

fi 

return SRC 



ff < n^ctoollist 

* This routine returns a full list of the tools subscrtbed to in the file 

# given as argument. 

mictooilistO { 
typeset RC 

> SluLr> # ** ia With Do mor condition 

for SK? * Wlth °° ™ »* 

If eliminate comments and black Hoes 

{ CleanComm < JsubfUe 1 1 echo •CleanComm $?• >UnTMc2 J 

# get excluded tool names '* 
{ sed 7 T !]/d; sT!//" 1 1 echo 'sed $?• >$errf,le2 ;} I 

if expand any metanames 

{ expandtooJs ) | echo 'cxpandtoob S?" >SerrfUe2 } I 

# sort the list *' 1 
{ sort-u > Stmpexclude 1 1 echo "sort!?' >Serrfl.e2 ;} 

if test -s Serrfile2: then break; fi # Break out of loop on error 

if move previous tool list 

{ mv $tmpsubscr2 Stmpsubscrl | J echo "rav $?• >$crrftlc2 .} 
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if test -s SenfileZ: then break: fi * Break out of loop on error 

» eliminate comments and blank lines . 

( cieanComm < Ssubfile 1 1 echo -CieanComm $?' >Serrf.le2 :> | 

tt get subscribed tool names 

{ sed TUi' 1 1 echo "sed $?' >$errfile2 :} i 

a expand any metanames 

{ expaodtools 1 1 echo "expandtools $?' > Jerrf.lel ;} | 

# add previous tools and sort them 

{ sort u - Stmpsubscrl 1 1 echo "sort J?" > Jerrf.le2 .} | 

( ZZ'-V^Z™" SonpsubscrZ , , echo 'comm Sr >Serrfi, 2 :, 
if test -s SenflleZ; then break; fi * Break out of loop on error 



done 



if test -s Scrrfile2: then 

read ECMD ECODE < $crrrtlc2 

echo 'SO: Error SECODE* reported by SECMD >&2 
RC-SECODE 

ClSC cat Stmpsubscrl * return the final list 

RC=0 

n 

return SRC 

> 



^ < extractsection 

J This routine extracts given sections of input Hies that are terminated by 



n the EOF line. 



extraciscctionO { 
integer section-$l 
typeset inputf.lc=$2 
integer i- 1 

typeset LINE done- false 

while not Sdone read LINE; do 
if ((i > section)); then 

done » true 
eiif test "SLINE- - "SEOF - ; then 
D) 

clif ({i 33 » section)); then 
echo "SLINE" 

fi 

done < Sinputfile 



^ < mail news 

maitnewsO { 



r^^^t NEWSTTME = $HOME/.maiIriews_rimc NEWSDIR «■ SADMRUG/news 



if test -d SNEWSDIR -a -n "$*': then 
cd SNEWSDIR 
for file in $(is -tr); do 

if test Sfile -nt SNEWSTTME; then 
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echo "\tAnnouncrnem '$file' mailed to $*" 
{ 

echo "Subject: Exptools announcement" 
5 echo 

cat Sfile 
} I /bin/mail $* 

fi 

done 
cd - 

fi 

10 touch SNEWSTDME 

} 

ft < salutation 

salutation() { 
15 if not SSALUTATION: then 

SALUTATION* true 
c c 




echo > To the Exptools Administrator of server SLOCAL1D'" 

fi 



# < c jj| cntsort 

# 

U This routine sorts clients, based on the depth and number of machine in the 
25 * cascade they serve. This allows clients who have deeper and more numerous 

# cascades to get their tools first and begin serving them sooner. 

clicntsortO { 
typeset CL 

integer DEPTH MAXDEPTH MAC H COUNT WEIGHT 
for CL; do 

20 typeset PKGRLE »$HOME/rjc/$LOCAUD/$CL pkg 

MAXDEPTH »0 MACHCOUNT«0 WEIGHT -0 
if test -fSPKGFILE; then 
extractsection 3 SPKGFTLE | 
while IFS-: read DEPTH REST: do 

if f (MAXDEPTH < DEPTH)); then 
35 ((MAXDEPTH - DEPTH)) 

ft 

if ((DEPTH .« I)); then 
((MACHCOUNT +=1)) 

fi 

done 

40 ((WEIGHT « MAXDEPTH + MACHCOUNT/4)) 

echo *S WEIGHT SCL* 

done | 

sort +0 -Inr +1 | 
while read DEPTH CL; do 
echo "SCL" 

45 done 
} 



* < main 
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autoload take 
cd 

GETOPT»S(gctoptcdprRl:t: "S®") 
if((S?i«0)); then 

echo -SUSAGE' 

exit 2 

fi 

set ~ SGETOPT 

debug="" 
LOCAUD-"* 
RESEND- false 
CHECKSUMS m false 
USEPLIST- false 
NULL MEANS ALL = true 

$ {THRESHOLD: -200} 
for arg in ; do 

case "Sarg* in 

-c> 

CHECKSUMS -true 
shift 

debugs echo 
shift 

-r) 

RES END— true 
NULL_MEANS_ALL- false 
shift 

-R) 

RESEND = true 
shift 

-P) 

USEPLIST-true 

shift 

» ♦ 

THRESHOLD— S2 

shift 2 

LOCALID-S2 

shift 2 

-) 

shift 
break 

esac 
done 

CLIENTUST--$^- 

if test ! -f SADMRUG/globai/config; then 

echo "SCMD: ERROR: Can t find RUG global config file" 
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exit 2 

fi 

. SADMRUG/global/config 

if lest -n *$LOCALID"; then 
FOUND= false 

for ID in SDEFAULTLOCALID SLOCALIDLIST; do 
if test "SID" = "SLOCALID*; then 
FOUND- true 

fi 

done 

if not SFOUND; then 

echo^SCMD: ERROR: Unknown local server ID SLOCALID' given - aborting! 

fi 
else 

if test -z "SDEFAULTLOCALID"; then 

echo^SCMD: ERROR: Default local server ID missing « aborting!' 

fi 

LOCAL ID = SDEFAULTLOCALID 

fi 

SADMRUG/giobai/linkconfig SLOCAUD 

ourfilc=$LINKDIR/server/update.out 

if test $(find Soutfile -miime + 1 -print | wc -I) -ne 0; then 

^ JENDUPDATES_DORMANT=true * Sendupdates has been asleep! 

fi SENDUPDATES,DORMANT=false * Sendupdates running as usual 

Sdebugcval "exec > Soutfile 2 >&1" 
echo "Start *date*\n" 

EXPTAB = SLINKDIR/server/exptab CMApt r ^ VT& D 

EXPPKGID = SLOCALID CXport 

RJE=SHOME/rjc/$LOCALID 

NEWFILES «SHOME/adm/upd 1 . 1/lib/cpio.new 

NEWFILESCOPY* $HOME'adm/upd 1 . 1 /lib/cp io. ncw2 

: S{tmp:«/usr/tmp} 

tmpCi g nore«Stmp/$SCignore # List of files to ignore from Client 

trapSignorc=$tmp/$$Signore # List of files to ignore from Server 
tmpignfile=Stmp/S$ignfile tt Work file of files to ignore 

mpc hsi-sunp $Sc Ust g List of filcs t0 io t0 ^ 

mppI«i=Sunp/$$pl«t # sorted, uncommented client plist 

mpwl.st^tmp/SSwUst „ List of filcs u siM ^ tQ J" 

mpcp.o-$tm P /SScpio * C pio file to send to client 

tmpcxcludc-Stmp/SScxcI * Work list of excluded tools 

unpsubscrl=Stmp/S$subl # Work list of subscribed tools 

tmpsubscr2=$tm P /$Ssub2 # Work list of subscribed tools 

tmpCNTmodel = Stmp/SSCmodel U Names of files desired by client 

tmpCNTphst«Stmp/$$Cplist # Client plist with excluded files removed 
impSRVtools=Stmp/S$Stools ft List of tools offered 
cmpSRVplist-Stmp/SSSplist # Plist of files offered to client 
rmppkgfile-Strnp/SSpkgfile U Work file of packages client subscribes to 
tmpfilcs-Stmp/SSfiles n Work file of file names 

E!l L S « P/$ r^ mdS * W0rtC fl,c for coramands » bc sent 

crrfile-Stmp/SSerrfile , Flag file for detecting errors in pipes 
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ScmpCNTplisi SimpSRVtools SimpSRVplist Slmppkgftle S.mpfiles Stmpcmdf.le Stmpsubscrl Stmpsubscrl Scrrt.le Serrl.le. 



rerval=0 
trap ' 

rcrvai = I 

exit 

trap ' 

trap - ERR 

emsg "Error code Sretval detected" 
exit Sretval 
ERR 
trap " ■ 

Sdcbug rm -f Stmpflist 

echo "Subject: SLOCALID gateway runlog\n" 
cat Sourfile 

Sdcbug /bin/mail S ADMIN EMAIL 
exit Sretval 
EXIT 



»,«»«*«**««*»*•«««*«»****•*«*•*******•******************* 



if SSENDUPDATES_DORMANT: then 
echo 

echo "WARNING: Sendupdates has not been run for over 48 hours!\a- 
ccho -*«•»***«*»*»***«****«************************"•*****" 

fi 

SRVplist= SLINKDIR/server/plist.S YRDAY 
S R V nisi = SUNKDlR/serveT/flist 
for file inSLINKDlR/scrvcr/pltst.*; do 
if [ -Sfile" !« "SSRVplUt" ); then 
rm -f Sfile 

fi 

done 

if test -z 'SCLIENTUST- SNULL_MEANS_ALL; then 
CLIENTLIST* x findclicni STYPE" 

fi 



echo "Clients: 
SCLIENTLIST" 

if S RES END: then 

for CHENTID in SCLIENTUST; do 

CUENTID«S(talce 8 SCLIENTID) 

EXPPWD=SLINKDIR/cJicnt/$CUENTID/.pwd 

if test -s SLINKDnUclient/SCLIENTID/uidnamc; then 

altutd « '-u$( < SLlNKDIR/crtent/SCLiENTID/uidnarne)* 
else 
aim id « 

fi 

tmpdiff « SRJE/SCUENTID-diff 

SUSPENDED * SUNKDIR/clicni/SCLIENTID/Suspended 
if test ! -f Stmpdiff; then 

echo "\n~ > No diff file found for $CHENTID\a- 
clif test -f SSUSPENDED &&. $NULL_MEANS_ALL; then 

echo '\n--> Client SCLIENTID currently suspended- 
else 
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cc«*wc -I < StmpdifT 
if I "Sec* -cqO ); thea 

echo "\n\tNo updates for SCUENTID" 



eJse 



fi 

fl 

done 



echo "\n\tChanges for SCUENTID: " Sec 
senddelfiles SCUENTID StmpdifT 
sendrrrodirs SCUENTID StmpdifT 
sendchmods SCUENTID StmpdifT 
scndrcpfiles SCLIENTID StmpdifT 
dirJog SCUEfmD StmpdifT 
updlog SCUENTID StmpdifT 



etif SUSEPLIST 1 1 SCHECKSUMS || not plistOK SSRVplUt; then 

cat SEXCLUDEUST 
geniinicdirs S LOCAL ID 
} ( mlcsed -w > StmpSignore 
ifSUSEPUST; theo 

echo "VnAcceptiag current checksums ..." 



etse 



echo "VnCreating upward cascade map" 
UPDLOG -STOOLS/adm/updl . l/lib/updlog 
CPIOLOG- STOOLS/adm/upd 1 . 1 /lib/cpio. log 
TZ-SOLDJTZ date | read X X X X TIMEZONE REST 
MONTH -"DATE- 
DAY- "UNKNOWN! • 
TIME-"" 

if rest -f SCPIOLOG -a ! -f SADMRUG/.ovcn then 

SSSSZIX^g ' ~ X X X X X M °™ ™ ™ E REST 
clif test -f SUPDLOG; then 
S/^eIS^ I X X X X X MONTH DAY TIME REST 

fi 

integer LEVEL 

C ASC ADEFILE = S LXNfCD IR/gl obal/cascade 
echo -l;SLOCAUD:SMONTH SDAY S7TME" > SCASCADEFILE 
for ID m S DEFAULTS ERVERID SSERVERIDUST; do 
if test -f SADMRUG/SID/globai/cascadc; then 

whiJc IFS- read LEVEL SERVER TTMESTAMP- do 
((LEVEL +- 1» 

echo " $ LEVEL: SS ER VER : STIMESTAMP" 
done < SADMRUG/SrD/globai/cascade > > SCASCADEFILE 

done 

chmod 664 SCASCADEFILE 
cat SCASCADEFILE 



echo "\nC renting downward cascade map* 

echo "\nNOTE: This cascade map generated $(date)* 
showtree -I SLOCALID 
} > SLINfCDIR/Iocai/cascade 

echo "\nChecJcing on exptools announcements" 

LOC AL_ ADMIN_EMAIL - S ADMIN EMAIL 
if test -n "SDEFAULTS ERVERID"; then 

SADMRUG/global/iinJcconfig SDEFAULTSERVERID 
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SERVER_ ADMIN _EMAiL = SADMIN_£MAJL 

else 

SERVER^ ADMIN_EMA1L * * " 

if test "SLOCAL ADMIN EMAIL" !« "$SERVER_ADMIN_EMAIL"; then 
mailncws SL0CAJL_ADMIN_EMAIL 

ft 

) 

echo "\nCalculating new checksums ..." 

rm -f SRJE/UpdateStarted SRJE/Update Ended SRJE/RequestEnded Serrfiie 

1 mktoollist SSUBSCRL1ST 1 1 echo "mktoollist $?" > Serrfiie 
} > StmpSRVtools 

if test -s Serrfiie: men 

emsg 'Failure preparing server cool list' "$( < Serrfiie)" 
rm -f StmpSRVtools 
exit 2 



if test ! -s StmpSRVtools; then m 
echo "SCMD: ERROR: No tools being served by this server - aborting! 
exit 2 

fi 

if not fgrep -x updtools StmpSRVtools >/dev/nuli 2><8tl: then 

echo "SCMD: ERROR: Essential tool 'updtools' not being served aborting!* 
exit 2 

fi 



# Get filenames for tools served 

{ TOOLS*$HOME STOOLS/a^m/updl. 1/bin/prpkg -ir < StmpSRVtools 1 1 

echo "prpkg $?" > Serrfiie ;} | 

# Put in sorted order 

{ son . u | | echo "sort S?" > Serrfiie ;} | 

# Add directories to complete list 

{ STADMRUG/bin/dirfillout ! | echo "dirfillout $?" > Serrfiie ;} | 

U Remove server-ignored files 

{ sed -f StmpSignorc | | echo "sed S?" > Serrfiie ;} 1 

n Get plist data for given files 

{ time STADMRUG/bin/mXplist -m | | echo 'mkplist $?* > Serrfiie ;} | 
U Put in sorted order 

{ sort -u 1 1 echo "sort S?" > Serrfiie ;} 

echo "SEOF" 
} > SSRVpiist 

if test -s Serrfiie; then 

emsg "Failure preparing server checksums" "$(< Serrfiie)" 
exit 2 

fi 

fi 

if notplistOK SSRVpiist; then 

echo "SCMD: ERROR: Corrupted plist file SSRVpiist' - aborting!" 
exit 2 

fi 

rm -f SNEWFILES # Remove previous list of new files 

if not SUSEPLIST; then 

> SRJE/UpdateStarted 

fi 
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10 



OVERTHR£SHOLD= false 
LONGTERMPROB « false 
MISS LNG REPORT- fai sc 
SUBSCRIBEERROR « false 
echo "\nCurrent update chreshold: STHRESHOLD" 

echo "NnThe clients below are processed according to the sizes of their cascades " 
echo "largest first." 

for CLIENTID in $<clientsort SCLIENTLIST); do 
CLIENTlD = $(iaJce 8 SCLIENTID) 
cleanupclicni SCLIENTID SYRDAY 

SUSPENDED=$UNKDIR/client/$CUENTID/Suspcnded 
if test f SSUSPENDED: then 

echo "\n~-> Client SCLIENTID currently suspended" 
else 

EXPPWD - SLINKDIR/client/SCLIENTlD/ .pwd 
if test -s SUNKDIR/cIicnt/SCLIENTID/uidname; then 
15 altu *« --u$( < SLINKDIR/clicnt/SCLIENTID/uidnamc)- 

eise 

aituida 

fi 

CNTpiist=$RJE/$CLIENTlD.$YRDAY 
CNTpkgfile«$RJE/SCLIENTID.pkg 
20 if not plistOK SCNTplist: then 

if test ! -f SCNTpIisc then 
MISSING REPORT « true 

echo *\n~ > No plist file found for SCLIENTID\a" 
integer DAYSOLD=0 
if test ! -f SCNTpkgfile; then 
25 cch0 " No package file found for SCLIENTID" 

car no. ^NDUPDATES.DORMANT A* „ SCNTpKgn.e - mtime -3 - priw 2 > Ihen 

^D^STJ^^ +SDAYS0LD "Prim 2>/dev/„ Ull )- : d0 

done 

2Q ((DAYSOLD — 1)) 

ccno ' T*" 5 c, «cnt hasn't reported for SDA YSOLD days!" 

if((DAYSOLD!«0));then 

ADMIN DATA «$ LIN KDIR/clicnt/SCLIENTID/admindata 
if test -f SADMINDATA; then 
typeset NAME EMAIL 
35 while read FIELD VALUE; do 

case "$ FIELD" 

in NAME) NAME- "$ VALUE" 

;; EMAIL) EMAIL = "S VALUE" 

esac 

done < SADMINDATA 
40 if f[ "S EMAIL" != @(none|NONE|") JJ; then 

echo 'Subject: exp tools errors* 
echo 

if [I *SNAME" @(none|NONE|--) JJ; then 
echo "ToSNAME:" 
^5 echo 

fi 

echo "The RUG update code has detected an error. Your client 'SCLIENTID' has not" 
echo reported to .ts server SLOCAUD' for the last SDA YSOLD days. PleaseThe^' 
echo your system to see what is causing this problem. Consult the 'rugadnV HELP" 
^subsystem for adv,ce. The rugcheck' command may also be helpful" 
50 «*<> »n identifying the cause of this problem ■ 

echo 



55 



BNSDOCID: <EP 0782080At J_> 



27 



EP 0 782 080 A1 



echo -UXtUUSLOCAJUD Exptools update routine" 
} | mail S EMAIL 

echo * Warning notice sent to $ EMAIL. " 

else m 

echo ' No administrator email address on file for * SCLENTED* . " . 
echo • Warning notice NOT SENT to that machine s Expiools administrator. 

fi 

fi 

if ((DAYSOLD%5 — 0)); then 

' echo "Subject: expiools client trouble* 

«ho "The RUG update code has detected an error. The client SCLIENTID* has nof 
So -r^oned SLOCMJD' for the last SDAYSOLD days. Please contact- 
echo "the exptools administrator of that system to see what might be causing this 
echo 'problem- You can consult the 'rugadm' HELP subsystem for advice. 

echo . m 

echo "\f\t\t\t$LOCALID Exptools update routine 

} | mail SA0MIN.EMAIL 

echo " Warning notice sent to S ADMIN_EMAIL. " 

n 

ri 

else 

echo "\n~> Corrupted plist file found for SCUENTIDNa* 

fi 

clif not pKgnieOK SCNTpkgfiie: then 
if test ■ -f SCNTpkgfiie: then 

MISSlNGREPORT-tnic * . 

echo '\n-> No package file found for $CLIENTID\a 
else 

echo "\n— > Corrupted package file found for $CLIENTID\a" 

fi 



else 



echo -NnProcessing SCLIENTID 'date*' 

sleep 10 * Allow other processes to be cleaned up 

> Scrrfile 

if test • -f StmpSRVtoots; then 

{ mktooUist SSUBSCRLIST 1 1 echo -mktoollist $?' > Scrrfile 

J > StmpSRVtools 

if test -s Scrrfile; then 

cmsg -Failure preparing server tool list* "$(< SerrfUe) 
rm -f StmpSRVtooU 
exit 2 

fi 



if test ! -s StmpSRVtools; then . 

echo -$CMD: ERROR: No tools being served by this server - aborting! 

exit 2 

if not fxrep -x updtools StmpSRVtools > /dev/null 2 > & I. then 

echo -SCMD: ERROR: Essential tool updtools* not being served aborting! 



exit 2 
fi 

extractsecttofl I SCNTpkgfiie > Stmppkgfile 
cxtractsection 2 SCNTpkgfile | 
mksed > S tmpC ignore 
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if test ! -s Stmppicgfile: then 

s^^sssKsr" requested by this c,ient -- **>"«'■■ 

continue 

fi 

if nor fgrcp -x updtools Scmppkgfiie >/dev/nulI 2>&1- then 
continue 

fi 
{ 

# Get tools subscribed to 

I Stmpplcgfile 1 1 echo -mkiooilist $?- >$errfile *} I 

# Intersect with offered tooJs ' 1 

{ comm -12 - SrmpSRVtooIs 1 1 echo "com m $?• > Serrfile - } I 

# Get filenames ' ' 

{ TOOLS=$HOME STOOLS/adm/updl. l/bin/prpkg -ir 1 1 

# Put in sorted order .. echo >^file :> I 
{ sort -u 1 1 echo - sort $r > $CTTfile . . . 

# Add missing dirs to list 

{STADMRUG/bin/dirnilow 1 1 echo -dirfillout 5V >$errfUe-J I 
U Remove client-ignored files ■' 1 

" ech0 ' scdS? * >lCTrt -"-» ' 

{ sort -u J | echo 'sort $?• > Serrfile :} I 

{ /usr/bin/join -j I -f • . JSRVplist 1 1 

} > StmpCNTmodel ^° " j ° in S? " * SerTfl,e : » 

if test -s Serrfile: then 

cTnln^ '«< SenfUer 

fi 

if test ! -s StmpCNTmodel; then 
continue 

fi 

CleanComm < SCNTpUst ! a n~«~ 

cut -fl $tmppl,st | „ Get ^ clieM file 

cc= wc -I < StmpdifT 

" 2™ Pr0f,lc " Stm P dirf >/dev/null 2>&1; then 
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while test -n -S(find SPROBFILE -mtime -rSDAYSOLD -print 2 > /dev/null)': do 
((DAYSOLD +- I)) 

done 

((DAYSOLD — D) 

if ((DAYSOLD > 7»; then 

LONGTERMPROB* true 

STAHS-**** " 

else 

STARS="" 

n 

echo "\t ${STARS}This client has been over threshold for SDAYSOLD days!" 

ft 



else 



> SPROBRLE 
OVERTURES HOLD* true 

fi 

clif { "Sec" -eqO ]; then 
rm -f SPROBFILE 

echo "\tNo updates for SCLIENTID" 
else 

rm -f SPROBRLE 

echo *\tChanges for SCLIENTID: " Sec 
senddelfiies SCLIENTID Stmpdiff 
sendrrmdirs SCLIENTID Stmpdiff 
sendchmods SCLIENTID Stmpdiff 
sendrepfiles SCLIENTID Stmpdiff 
dirlog SCUENTID StmpdifT 
updlog SCLIENTID Stmpdiff 

fi 

cp Stmpdiff SRJE/SCLIENTTD.diff 

fi 

n 

done 

SALUTATION = false 

if SOVERTHRESHOLD; then 

salutation 

cat < <-! 

***************************************************************************** 

Some systems have EXCEEDED the nightly update threshold. Systems with more 
than STHRESHOLD changes will not be updated except through the express approval 
of the cxptools administrator. See the rugadm HELP screen "Approving the 
rcsending of update files to client machines* to see how to issue such an 
approval. 

I 

n 

if SLONGTERMPROB; then 
salutation 
cat < < -! 

***************************************************************************** 

Some systems have been over threshold for 7 days or morel Please determine 
why these systems have not gotten their updates. 

I 

a 

if SMISSINGREPORT; then 
salutation 
cat < < -! 
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Some clients did not send in their nightly reports in time to be included in 
today's update processing. See the rugadra HELP screen "Checking on client 
reports" for tips on how to handle this problem. 

**«.*«»**»«• •••*wmm999m*»w**mMMm mMmm999mm9amm9mMm 

I 

rl 

if SSUBSCRIBEERROR; then 
salutation 
cat < <-! 

Some clients have problems with their subscription lists. Sec the rugadm 

HELP screen 'Understanding RUG ERROR messages" for tips on how to handle this 

problem. 

*»»******««*********«**«*»«*.*«.««.«^ 

i 

fi 

if notSUSEPLIST; then 

> SRJE/UpdatcEndcd 

fi 

elif test -s SNEWFILES; then 

echo "\nSending out newly arrived flies ..." 

cp SNEWFILES SNEWFILESCOPY 

{ 

cat SEXCLUDELIST 

gcnlinkdirs SLOCALID 
} | micscd -w > StmpSignore 
for CLIENTID in SCLIENTLIST: do 

EXPPWD - SLINKDIR/cliem/SCLIENTID/.pwd 

if test -s SLINKDIRycltcnt/SCLIENTID/uidname: then 
altuid - "-uS( < $LINKDIR/clicnt/$CUENTID/uidnamc)" 

else 

altuid = 

fi 

C NTpkgfile = S RJE/SCLIENTID . pkg 
if notpkgfileOK SCNTpkgfile: then 
if test! -f SCNTpkgfile; then 

echo "\n— > No package file found for SCLIENTIDVa" 

else 

echo "\n— > Corrupted package file found for SCLIENTIDVa" 

fi 
else 

echo '\nProcessing SCLIENTID *date fc " 

> Serrfiie 

if test ! -f StmpSRVtools; then 

{ 

mktooliist SSUBSCRUST 1 1 echo 'rnktoollist S?" > Serrfiie 
} > StmpSRVtools 

fi 

if test -s Serrfiie; then 

emsg "Failure preparing server tool list" "$(< Serrfiie)" 
rm -f StmpSRVtools 
exit 2 

fi 

if test ! -s StmpSRVtools; then 

echo^-SCMD: ERROR; No tools being served by this server - aborting!" 

fi 
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extractsectton 1 SCNTpkgfile > Stmppkgfile 
cxtractsection I SCNTplcgfile | 

mkscd > StmpCignorc # Client-ignored files, scdscr 

if tesi ! -s Stmppkgfile; then . . ,. 

echo -$CMD* ERROR: No tools being requested by this client - skipping! 

continue 

fi 

sed -f StmpCignorc SNEWFILES | U Remove client-ignored files 
TOOLS -SHOME STOOLS/adm/upd 1 . 1/bin/pkgpath -a | * Get toolnames 
sort -u > StmpCNTmodcl * Son new tool:file list 

# Get tools subscribed to 

{ mktoollist Stmppkgfile 1 1 echo "mJctoollist $?* > Serrfile :} | 
n Intersect with offered tools 

{ coram -12 - StmpSRVtools 1 1 echo "coram S? > Scrrfile .} | 
U Put in sorted order 

{ son -u 1 1 echo 'sort $?" > Serrfile ;} | 

U Join with new tool:file list 

{ /usr/bin/jom -t: - StmpCNTmodcl ) | 

echo "join S?*> Scrrfile ;} | 

# Exiract me file names 

{ cut -d: -f2 II ec* 10 " cut %V > 5err fllc •) I 

# Put in sorted order 

{ sort -u II echo "sort S?' > Serrfile ;> | 

« Put in update form 

{ sed '$/.»/+ &J' 1 1 echo "sed S?" > Serrfile ;} 
} > Stmpdiff 

if test -s Serrfile: then ^ ^, . 

emsg "Failure analyzing client SCLIENTTD checlcsums" "S(< Serrfile) 
continue 

fi 

cc*»*wc -1 < Stmpdiff 
if ( *Scc" -eqO }; then 

echo "UNo updates for SCLIENTID* 

else 

echo *\tChanges for SCUENTID: * Sec 
scndrcpfiles SCLIENT1D Stmpdiff 
updlog SCLIENTID Stmpdiff 

fi 

cp StmpdifT SRJE/SCUENTTD.difTZ 

fi 

done 

if cmp -s SNEWFILES SNEWFILESCOPY; then 
rm SNEWFILES SNEWFTLESCOPY 

else 

comm -13 SNEWFILES SNEWFILESCOPY > Stmpfilcs 
mv Strapfiles SNEWFILES 
rm SNEWFILESCOPY 

fi 
else 

echo *\nNo reason to send files, none will be sent!' 

fi 

echo "\nFimsh % date " 

Sdcbug cat Soutfile > > SUNKDIR/server/Runlog 
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Claims 

1 . A system for propogating revisions through a communications network, comprising: 

status reporting circuitry, associated with a second node of said communications network, for collecting and 
transmitting a current status of second node information stored in a memory of said second node; 

first information revising circuitry, associated with a first node of said communications network, for receiving 
said current status from said second node, determining as a function of said current status whether a revision 
of said second node information is required and, if said revision is required, transmitting said revision to said 
second node to revise said second node information; and 

second information revising circuitry, associated with said second node of said communications network for 
receiving a current status from a third node of said communications network, determining as a function of said 
current status from said third node whether a revision of third node information stored in a memory of said third 
node is required and. if said revision is required, transmitting said revision received from said first node to said 
h.rd node to revise said third node information, said revision thereby propagating through said communica- 
tions network vi a said first, second and third nodes thereof. 

The system as recited in Claim 1 wherein said second information revising circuitry includes memory for storing a 
subscriber list, said second information revising circuitry transmitting said revision as a function of a content of said 
subscriber list. 

"me system as recited in Claim 1 wherein said status reporting circuitry collects and transmits said current status 
of said second node .nformation to said first node at a first time, status information circuitry associated with said 
third node collecting and transmitting said current status from said third node to said second node at a second time 
said second time subsequent to said first time by a period of time sufficient to allow said second node information 
to be fully revised before said second information revising circuitry transmits said revision to said third node. 

ESSST 3S re S 6d in C ' aim 1 Wherei " 531(1 S6cond inf0 ™a«°n ^vising circuitry is embodied in a sequence of 
nstructions operable on a second processor associated with said second node, said revision capable ofincluding 

c^to S be°mSK ,UenCe ° f inStrUC,iO^S • thefeby a " 0Win9 3n ° Perati0n ° f SeCOnd info "^' on revis ^ 

The system as recited in Claim 1 wherein said communications network is hierarchical, said first node functionina 
as a server for sa.d second node, said second node functioning as a server for said third node. n,nct,onin 9 

lu^nSnn^^ ?HH1 1 Wherei " SaM ** informafon ™*"9 circuitry includes first security circuitry for 

222£EJ^ St9tUS fr ° m l * S6COnd node before «* f irst noda transmits saw revision to 

said second node and sa.d second node includes second security circuitry for authenticating said revision received 
from sad first node before revising said second node information received 



7. The system as recited in Claim 1 wherein said first information revising circuitry revises said second node informa- 
tion by togginc jon to said second node and transmitting a sequence of commands to said second ncS to enrte 
is said second node to receive said revision. TOe ro enaae 

8 " tT"^T^r MOnS nM ^ Pf0Pa9atin9 r£ViSi ° nS — ~^tions net- 
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collecting and transmitting a current status of second node information stored in a memory of a second node 
of said communications network; noae 

n^t V ii Said CUrr6n1 S,3tUS * r ° m Mid S6COnd node into 3 f irst node of saf d communications network said first 
node determining as a function of said current status whether a revision of said second node inforratonfs 

lnH eiV i 9 w c " rrerrtstatus ,rom a third nod e of said communications network into said second node said sec- 
ond node determming as a function of said current status from said third node whether a Son o^th^rSe 
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information stored in a memory of said third node is required and. if said revisions required transmit* ing « dd 
revision received from said first node to said third node to revise said third 

thereby propagating through said communications network via sad first, second and third nodes thereof. 

9. The method as recrted in Claim 8 wherein said step of receiving said current status from said third 

the step of transmitting said revision as a function of a content of a subscriber list stored in said memory of said 
second node. 

10 The method as recited in Claim 8 wherein said current status of said second node information is collected and 
transmitted to said first node at a first time, said method further comprising the step of collecting and transmitting 
said current status from said third node to sad second node at a second time, said second time subsequent to sad 
f irst time by a period of time sufficient to allow said second node information to be fully revised before said second 
information revising circuitry transmits said revision to said third node. 

1 1 The method as recited in Claim 8 wherein said second node includes a sequence of instructions operable on a sec- 
' ond processor associated with said second node, said revision capable of including revisions to said sequence of 

instructions, thereby allowing an operation of said second node to be modified. 

12. The method as recited in Claim 8 wherein said communications network is hierarchical, said first node functioning 
as a server for said second node, said second node functioning as a server for said third node. 

1 3. The method as recited in Claim 8 further comprising the steps of: 

authenticating said current status received from said second node before said f irst node transmits said revision 
to said second node: and 

authenticating said revision received from said first node before revising said second node information. 

14 The method as recited in Claim 8 said step of receiving said current status from said second node into said first 
node comprises the step of revising said second node information by logging on to said second node and transmit- 
ting a sequence of commands to said second node to enable said second node to receive said revision. 

1 5. A system for propogating revisions through a hierarchical communications network having a host, a first-level node 
and a second-level node, comprising: 

status reporting circuitry, associated with said first-level node, for collecting and transmitting a current status of 
first-level node information stored in a memory of said first-level node at a first time; 

first information revising circuitry, associated with said host, for receiving said current status from said first-level 
node determining as a function of said current status whether a revision of said first-level node information is 
required and. if said revision is required, transmitting said revision to said first-level node to revise said first- 
level node information; and 

second information revising circuitry, associated with said first-level node, for receiving a current status from 
said second-level node at a second time, determining as a function of said current status from said second- 
level node whether a revision of second-level node information stored in a memory of said second-level node 
is required and. if said revision is required, transmitting said revision received from said host to said second- 
level node to revise said second-level node information, said second time subsequent to said first time by a 
period of time sufficient to allow said first-level node information to be fully revised before said second informa- 
tion revising circuitry transmits said revision to said second-level node, said revision thereby propagating 
through said communications network via said host, first-level and second-level nodes thereof. 

16. The system as recited in Claim 15 wherein said second information revising circuitry includes memory for storing 
a subscriber list, said second information revising circuitry transmitting said revision as a function of a content of 
said subscriber list. 

1 7 The system as recited in Claim 1 5 wherein said second information revising circuitry is embodied in a sequence of 
instructions operable on a second processor associated with said first-level node, said revision capable of including 
revisions to said sequence of instructions, thereby allowing an operation of said second information revising cir- 
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cuitry to be modified. 



18. Jhe system as recited in Claim 15 wherein said first information revising circuitry includes first security circuitry for 
authent.cat.ng sa.d current status received from said first-level node before said host transmits said revision to sakJ 

i£ZZ ETi? ^ f ^ H ^ I heW " second security circuitry for authenticating JJlS^SS 
from said host before revising said first-level node information. 

19 ' i!ie e basS em ^ feCi,ed in C ' aim 15 Wh6rein *** S6C0nd Se ° Urity CifCUitry authenti «** said revision on a file-by- 

2 °" UUST? 85 reCi,ed in C '! im 15 Wherein Said f iret information ^vising circuitry revises said first-level node infer- 

S2SJ,° f 99, , n , 9 °" t0 J aKl f ' reHeVel n0de and •*«**'Q a s **<ence of commands to said fhZL£m* Tto 
enable said first-level node to receive said revision. 

21 " l?onTf^l OP f 9a J! n9 ?^ Si ° nS thr ° U9h 9 communicatio "s "etwork. said communications network including at 
least one first level node, at least one second level node and at least one third level node, said system comprising 

status reporting circuitry, associated with said at least one second level node, operative to collect and transmit 
a second level current status of information stored in a memory of said at leastone second^ node 
first informa ton rev.s.ng circuitry, associated with said at least one first level node, operative to- (1 ) receive said 
second level current status of information from said at least one second level node. (2) drterrrtne aTaS 
of said second level current status of information, whether a revision of said at least one s<Zrt , V S 

< 3) S6,eCtiVely tranSmit ' in *» — determination. J£3EnS ?JEt 

second information revising circuitry, associated with said at least one second level node operative to- m 
receive a third .eve! current status of information from said at least one third levefncxJe (I) SSne as a 
functon of sa,d third level cunent status, whether a revision of said at least one w!^n!£E£££ 
stored in a memory of said at .east one third level node is required, and (3) selectively Imm^mSSR 

nrt^T °l "!? reViSi ° n r6CeiVed ,r ° m said at ,east one ,irst ,evel «* t° said at feast SSSSS 
node to rev.se said at least one third level node information, said revision thereby orooaoaton thmnoh «S 

tSSSST ^ 31 ^ ^ ,ifSt ,eVeL at ,6aSt ™ ^ff5S "el 
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FIG. 3 
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